home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 40 / Amiga Format CD40 (1999-05-11)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-06].iso / -seriously_amiga- / misc / gnu_emacs / em203i1.readme < prev    next >
Text File  |  1999-03-29  |  13KB  |  310 lines
  1. Short:    GNU Emacs-20.3 V2.10 Intuit. 28bit-seg
  2. Uploader: bertw@knuut.de (Bert Winkelmann)
  3. Author:   Patched by bertw@knuut.de (Bert Winkelmann)
  4. Type:     util/gnu
  5. Requires: OS-v39 (for GUI), 8MB RAM, 68ec20, IxEmul library
  6. Version:  AmigaOS patchlevel 2.10
  7.  
  8. This distribution holds version 20.3 of GNU Emacs, the extensible,
  9. customizable, self-documenting real-time display editor.
  10.  
  11.  {Sorry about my bad English.}
  12.  
  13. This Amiga port, like most IxEmul ports, is probably more close to its
  14. baseline version than previous ports. Despite of this, it haves also
  15. some of the Amiga features (ARexx, AppWindow, ASL).  The Intuition
  16. based GUI is very similar to the X GUI.  You should be able to use all
  17. GUI based Lisp applications without making any adaptions.
  18.  
  19. Normally you may want to use this program with Intuition, but you can
  20. also use it on terminals via AUX:.  It's also possible to run it on X,
  21. but you need a different configured programfile version for that.
  22.  
  23. Amiga related Features
  24. ======================
  25.  
  26.    AREXX port (not in X nor TTY-only versions)
  27.    
  28.    Intuition-GUI: multiple colors and font styles * multiple frames
  29.    (Intuition windows) on one or more public screens (and invisible
  30.    frames too) * vertical scroll bars * pens are not really obtained from
  31.    system until first use in drawing. * Workbench iconify and drag'n'drop
  32.    * clipboard support * pop-up menu (configurable, scroll-able, full
  33.    keyboard control) * ASL file+font requester (used by "Amiga" menu) *
  34.    provides most of old "amiga-" LISP-functions for compatibility with
  35.    formerly Emacs-18 AmigaOS port (e.g. amiga-set-geometry) * 2 different
  36.    modes for numeric keypad (NumLock) * provides Meta, Super and Hyper
  37.    modifier keys
  38.    
  39.    Console: amiga-set-font implements font changing on CON:
  40.    
  41.    TTY: you can open a sub shell if your shell implements no job-control.
  42.  
  43. Version Numbers
  44. ===============
  45.  
  46. There are two version numbers.  One ist the baseline version number
  47. (20.3).  Note that the diff archives contains currently patches for
  48. two different baseline versions (19.34 and 20.3).
  49.  
  50. The other number specifies the version of my patches (like V2.10).
  51. The current version is V2.10.  The version for the binary main archive
  52. is still V2.9.  It will be updated automatically if you install any of
  53. the program archive on top it (they contain not only the program files
  54. but also some updates to the main archive too (delta update)).
  55.  
  56.  
  57.  
  58. Parts of this Distribution
  59. ==========================
  60.  
  61. There exists both a source and binary distribution.
  62.  
  63. Source Code
  64. -----------
  65.  
  66. The source distribution comes in to different forms: a small diff
  67. archive and a big complete archive.
  68.  
  69.   ------------------  ----------------------------------------
  70.   em203dif.lha       - GNU Emacs 20.3 V2.10 diffs
  71.   em203src.lha       - GNU Emacs 20.3 V2.10 source
  72.   ------------------  ----------------------------------------
  73.  
  74. Note: The LhA archives contain "tar.gz" or even "tar.bz2" archives.
  75. You need a "tar" unarchiver (tar/untar) and the right decompression
  76. programs (gzip for .gz; bzip2 for .bz2).  I will limit the use of
  77. bzip2 to the really big (and rather uninteresting) source archive.
  78.  
  79. Note: If you want to compile Emacs yourself and having acces to the
  80. original baseline sources, you need only the diffs archive.  All you
  81. have to do ist invoking "sh install.sh 20.3 src/emacs-20.3" to patch
  82. the source. It's tested.
  83.  
  84. Binaries
  85. --------
  86.  
  87. The binary distribution consist of a single main archive and some
  88. Emacs program files (in different flavors).  Note: The installation
  89. should go into the "gg:" directory.  This could be a multi-assign too.
  90. Emacs depends on this.  Please read the README* file in the program
  91. archive to learn how to make the dumpfile (it's very easy now).
  92.  
  93. Note: Install the main archive *before* the program archive.
  94. Otherwise the newer files in the program archive would be overwritten
  95. by older versions from the main archive.
  96.                     
  97.   ------------------  ----------------------------------------
  98.   em203bin.lha      - GNU Emacs 20.3 V2.9 installed in gg: 
  99.  
  100.   em203i0.lha       - GNU Emacs 20.3 V2.10 Intuition 28bit 
  101.   em203i1.lha       - GNU Emacs 20.3 V2.10 Intuit. 28bit-seg
  102.   em203i3.lha       - GNU Emacs 20.3 V2.10 Intuition 32bit
  103.   ------------------  ----------------------------------------
  104.  
  105. optional more exotic flavors:
  106.   ------------------  ----------------------------------------
  107.   em203x0.lha        - GNU Emacs 20.3 V2.10 X 28bit 
  108.   em203x1.lha        - GNU Emacs 20.3 V2.10 X 28bit-seg
  109.   em203x3.lha        - GNU Emacs 20.3 V2.10 X 32bit
  110.   em203t0.lha        - GNU Emacs 20.3 V2.10 CON/AUX 28bit 
  111.   em203t1.lhaa       - GNU Emacs 20.3 V2.10 CON/AUX 28bit-seg
  112.   em203t3.lha        - GNU Emacs 20.3 V2.10 CON/AUX 32bit
  113.   ------------------  ----------------------------------------
  114.  
  115.  
  116.  
  117. What does 28, 28s and 32 bit mean?
  118. ----------------------------------
  119.  
  120. If your machine does not have RAM above 28bit, then everything is
  121. fine.  Just use the "28bit" version, which is faster than the others:
  122.  
  123. normal/28  - RAM inside 28bit address range is usable
  124.          runs on machines having only RAM upto 0x0fffffff
  125.          (use ShowConfig to learn about this)
  126.  
  127. If your machine has RAM above 28bit you have to use one of the
  128. following flavors which implements segmented RAM. Note: 28s is much
  129. faster than 32.
  130.  
  131. seg1/28s   - RAM inside one 28bit segment is usable (DATA_SEG_BITS feature)
  132.              runs on machines with FastMem above 28bit
  133.          RAM in range 0xZ0000000..0xZfffffff (i.e. the high nibble (Z)
  134.               must be the same for all usable RAM))
  135.  
  136. seg3/32    - RAM inside 8 independent 25bit segments usable
  137.              runs on machines with both FastMem above and below 28bit.
  138.          (allows using of mixed RAM not being in a common
  139.               28bit block (i.e. with a different high nibble))
  140.  
  141.  
  142. Here comes additional info taken from my WWW page.
  143. ===========================================================================
  144.    
  145.    DESCRIPTION
  146.    
  147.    This project is about running GNU Emacs 19+20 on AmigaOS using the
  148.    IxEmul library and GCC. It supports both the native AmigaOS window
  149.    system "Intuiton" (>=V39) and X (and of course plain terminals too).
  150.    
  151.    The Intuition GUI implements almost all features of the X GUI except
  152.    16bit fonts. You will also get Drag'n'Drop and an ARexx port.
  153.    
  154.    I have tried to make it so compatible as possbile to prevent you and
  155.    me from changing any LISP packages. You should never have to change
  156.    path syntax, font names, window system names. On the other hand, you
  157.    can use ASL file and font requesters via the Amiga menu item. You can
  158.    use AmigaDOS path syntax in some LISP commands too.
  159.    
  160.    The current patch-set supports the following baseline versions:
  161.    GNU-Emacs-19.34b, 20.2, 20.2.92, 20.2.97, 20.3.
  162.    
  163.    
  164.    SYSTEM REQUIREMENTS
  165.    
  166.    For using intuition: graphics.library-39 or better is required. (part
  167.    of AmigaOS V39)
  168.    
  169.    General: A lot of RAM or virtual memory. A fast CPU is recommended. I
  170.    have only an 68030-40MHz which is sometimes too slow even for parts of
  171.    some standard ELISP packages.
  172.    
  173.    Note: Different ELISP packages may have very different RAM-/CPU-usage.
  174.    
  175.    LIBRARIES
  176.    
  177.    ixemul.library - the free UNIX kernel emulation + standard C library
  178.    (incl. socket interface)
  179.    
  180.    If you want to configure and build Emacs for running on X window
  181.    system, you will need the required X libraries and headers. A free
  182.    X11R6 package is part of ADE/GG. There are other X window ports, but I
  183.    have tested only ADE-X.
  184.    
  185.    NO PROBLEMS
  186.    
  187.    I used Emacs (20.2) mainly as programming environment, to write HTML
  188.    and as editor for an external News+Mail-reader.
  189.    
  190.    I have used the following packages very often:
  191.    
  192.    c/c++-mode (indenting slow since 20.2) * font-lock/fast-lock (in 20.2
  193.    sometimes you have to restart it because of a not complete fixed bug)
  194.    * ETags * sh-mode * Info * Ediff * GUD (for programs using signal
  195.    handlers (like Emacs itself) it's better to use gdb on console because
  196.    there are no process-groups and Emacs handle/blocks some signals). *
  197.    Emacs-Server * HTML-mode * ELISP modes and tools like debuggers and
  198.    profilers. * Occur, IMenu, HS
  199.    
  200.    I have tested, but don't use the following packages:
  201.    
  202.    AucTeX (seems to work OK but I don't need it currently) * GNus (works,
  203.    but is very slow on my machine) * W3 (works, but is very slow) *
  204.    Ange-FTP (needs PTYs, you have to install+run Devs:fifo.handler).
  205.    
  206.    BUILT-IN WORKAROUNDS
  207.    
  208.    HOME variable is translated from AmigaOS to UNIX syntax at startup of
  209.    Emacs, EmacsServer, EmacsClient. That means all subprocesses inherit
  210.    the UNIX syntax version. (prevents problems by using $HOME as kind of
  211.    ID on sockets).
  212.    
  213.    The home directory read from password files will be translated to UNIX
  214.    syntax.
  215.    
  216.    A built-in default TERMCAP entry for TERM=amiga exists.
  217.    
  218.    Note: Internally Emacs uses UNIX-path syntax (to gain maximal
  219.    compatibility with ELISP packages written for UNIX). I changed a few
  220.    user-interface functions to accept both UNIX- and AmigaOS syntax. This
  221.    works very well.
  222.    
  223.    The Intuition code inside of Emacs implements serveral X functions
  224.    (limited to the needs of Emacs). It even fakes the `window-system'
  225.    variable to X. Therefore, any ELisp package written for X should work
  226.    without any changes. To check for running on Intuition, you have to
  227.    test for (boundp 'amiga-i-windows).
  228.    
  229.    Console: Because `^C' is always handled by console (SIGBREAK_C) there
  230.    is a key-translation from C-z to C-c (located in
  231.    "lisp/term/amiga.el").
  232.    
  233.    FEATURES
  234.    
  235.    AmigaOS specific: Bidirectional AREXX port as interface to ELISP
  236.    language * Two different file-system path syntaxes.
  237.    
  238.    Intuition-GUI: multiple colors and font styles * multiple frames
  239.    (Intuition windows) on one or more public screens (and invisible
  240.    frames too) * vertical scroll bars * pens are not really obtained from
  241.    system until first use in drawing. * Workbench iconify and drag'n'drop
  242.    * clipboard support * pop-up menu (configurable, scroll-able, full
  243.    keyboard control) * ASL file+font requester (used by "Amiga" menu) *
  244.    provides most of old "amiga-" LISP-functions for compatibility with
  245.    formerly Emacs-18 AmigaOS port (e.g. amiga-set-geometry) * 2 different
  246.    modes for numeric keypad (NumLock) * provides Meta, Super and Hyper
  247.    modifier keys
  248.    
  249.    console: amiga-set-font implements font changing on CON:
  250.    
  251.    TTY: you can open a sub shell if your shell implements no job-control.
  252.    
  253.    MULE on Emacs-20: I merged in relevant parts of MBSK to allow
  254.    switching it (MBSK) on/off on different window systems. To enable MBSK
  255.    it's needed to pass the parameter "no-mule" to "lisp/loadup.el" at
  256.    dump-time. The Makefile do handle this automatically (using the
  257.    variable LOADUP_ARRGS): MBSK is per default enabled for Intuition-GUI,
  258.    but disabled for X.
  259.    
  260.    Example: To always disable MBSK compile with
  261.    $ make "LOADUP_ARGS=" ...
  262.    To always enable it use
  263.    $ make "LOADUP_ARGS=no-mule" ...
  264.    
  265.    BUGS
  266.    
  267.    Intuition: Italic font style is broken (it's nearly unusable for
  268.    editing) * Currently no gad-tools menu (we use the pop up menu by the
  269.    menu-bar too) * No 16 bit fonts. Use ADE-X to have a full working
  270.    MULE. * No working multi keyboard * Never tried a 2 button mouse, but
  271.    I guess there are ELISP-packages handling that problem already
  272.    
  273.    MultiUser: I have running MultiUser (mufs) on my system. This causes
  274.    the root directory of volume in RAM: having access bits
  275.    "700","drwx------". You cannot create files and call DirEd in that
  276.    directory. But you can/should change at least the access bits of
  277.    sub-directories in RAM: like this:
  278.    $ chmod 777 /ram/T /ram/ENV /ram/ClipBoards.
  279.    
  280.    TeX: IxEmul has a problem to pass `\' as part of arguments to all
  281.    non-ixemul binaries. This is a problem when using the TeX program from
  282.    PasTeX on Meeting-Pearls-CDROM. There is a workaround in directory
  283.    `amigaos/' using the small non-ixemul command-shell from
  284.    Emacs-18.59-amigaos. Another problem: killing a non-ixemul TeX binary
  285.    may crash the system. A ixemul port of TeX may work better. Such one
  286.    is part of ADE/GG.
  287.    
  288.    Soft-Links: The clash detection uses soft-links since Emacs-20.2. I
  289.    have no problems with this so far. In general, for editing files
  290.    visited over a soft-link you may need to use:
  291.    (setq find-file-visit-truename t)
  292.    in your ~/.emacs file. This may not required if you use the latest
  293.    BETA-ffs (http://www.amiga.de). Unluckily, as it seems, there is no
  294.    MuliUser patch for that FFS.
  295.    
  296.    HISTORY
  297.      * August '98: Emacs-20.3
  298.      * June '98: Emacs-19.34b updated. New distribution format (common
  299.        amiga specific files in base distributions and patches in updates;
  300.        bug-fix-patches in base-distributions; version patches for
  301.        baseline files in base distributions and updates)
  302.      * May '98: X window tested (ADE-X11R6.3 running on A1200-030/40)
  303.      * March '98: Clipboard and AREXX
  304.      * January '98: Emacs-20.2
  305.      * Winter '97: Emacs-19.34b
  306.      * Autumn '97: Emacs-19.29 (Intuition)
  307.      * Summer '97: Emacs-19.28 (Tty only)
  308. ===========================================================================
  309. '
  310.